home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / a2t23c.zip / A2T.DOC next >
Text File  |  1991-04-07  |  18KB  |  369 lines
  1.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2.   ░░░░░░░░░╔═══════════════════════════════════════════════════════╗░░░░░░░░
  3.   ░░░░░░░░░║              ┌─────┐             ┌─────┐              ║  ░░░░░░
  4.   ░░░░░░░░░║              │  ─  │             └─┐ ┌─┘              ║  ░░░░░░
  5.   ░░░░░░░░░║              │ ┌─┐ │      2        │ │                ║  ░░░░░░
  6.   ░░░░░░░░░║              └─┘ └─┘               └─┘                ║  ░░░░░░
  7.   ░░░░░░░░░╚═══════════════════════════════════════════════════════╝  ░░░░░░
  8.   ░░░░░░░░░░░                                                         ░░░░░░
  9.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  10.  
  11.   A2T version 2.3c  copyright (c) Robert Kirby
  12.  
  13.   Disclaimer:
  14.      Use this software at your own risk.  No guarantees or warranties.
  15.  
  16.   File info:
  17.   VALIDATE 0.3 Copyright 1988-89 by McAfee Associates.  (408) 988-3832
  18.             File Name:  a2t.exe
  19.                  Size:  15,904
  20.                  Date:  12-30-1989
  21.   File Authentication:
  22.        Check Method 1 - 7AD2
  23.        Check Method 2 - 11F2
  24.  
  25.   A2T.EXE --> executable program.
  26.   A2T.DOC --> the docs.
  27.  
  28.   Registration:
  29.      This is a shareware program.
  30.      Send $5.00 to:
  31.             Save the Chip Channel
  32.             P.O. Box 270019
  33.             Houston, Tx 77277-0019
  34.      Or call:
  35.             The Houston Chip Channel, BBS# (713)/660-7565
  36.             Node 860/1 of the PhoenixNet
  37.  
  38.  
  39.  
  40.        Introduction to A2T, the ASCII to Telix dial directory utility:
  41.  
  42.      This is a program to convert an ASCII file, such as a BBS list into
  43.   a Telix dialing directory.  The program is relatively fast and command
  44.   line driven.  I tailored the default configuration after a popular BBS
  45.   list that we have here in Houston called "Judy's List", and the most
  46.   common dialing directory settings for an IBM PC or compatible but these
  47.   defaults can all be overridden with the config parameter.
  48.      With A2T, I can set up all sorts of BBS lists that I download as a
  49.   Telix dialing directory without having to type them up.  A2T will compile
  50.   up to 1000 BBS names and numbers from an ASCII BBS list.
  51.      I have listed some configs for popular BBS lists towards the end of
  52.   this file.
  53.  
  54.   
  55.  
  56.  
  57.                       Instructions for running A2T:
  58.  
  59.   1) setup the bbs list - this is crucial for proper results.
  60.   2) if you plan to overwrite your current Telix dial dir,
  61.      MAKE A BACKUP of the file named TELIX.FON!
  62.   2) run a2t
  63.  
  64.  
  65.      At this time, A2T has 3 optional parameters.  They are the input
  66.   parameter, the output parameter, and the config parameter.  The input
  67.   parameter is the name of your BBS list in ASCII form.  This must come
  68.   BEFORE the output parameter on the command line.  The output parameter
  69.   if the name of the dialing directory file to be created.  Both of these
  70.   parameters are optional.  If you leave the first one off, A2T will assume
  71.   you are using an ASCII input file called INPUT.BBS and the output file will
  72.   automatically be OUTPUT.FON.  To take advantage of the second optional
  73.   output filename parameter, you must enter the first parameter also.
  74.   No suffixes are assumed, that is you must enter them (if you want them)
  75.   in the filename parameters.  You may enter paths for these parameters.
  76.      The third optional parameter is the config parameter.  This is how
  77.   you control the compiling of your BBS list.  The third optional
  78.   parameter is preceeded by a forward slash, and then a code list
  79.   to inform A2T what you want done with the BBS list.  This parameter
  80.   can appear anywhere on the command line, but you may have only one config
  81.   parameter.  Config codes can be strung together in the config parameter.
  82.      If you enter no config parameter at all, you will be given a dialing
  83.   directory that will use 2400bps, and the BBS list should use a '.' for
  84.   the delimiter for the BBS name, and a ' ' for the delimiter for the
  85.   phone number.  This was the easiest way to compile Judy's list, but
  86.   you can override these defaults with config parameters.
  87.      The codes in the config parameter are listed after the forward slash
  88.   and can be combined in various ways but they must have the proper
  89.   syntax as described below.  Note in the descriptions below, a COLUMN is
  90.   the width of ONE character.  Only the first 80 characters in each line
  91.   of the BBS list can be processed.
  92.  
  93.  
  94.                  Here are the config parameter definitions:
  95.  
  96.  
  97.   /?     where ? = ?  This simply displays a quick reference help screen.
  98.  
  99.  
  100.   /B?    where ? = 0, 1, 2, or 9
  101.            This is the Bps parameter code, and will define the bps rate that
  102.          you want in your dial dir.
  103.          Here are the code parameter definitions:
  104.          0 =  300 bps
  105.          1 = 1200 bps
  106.          2 = 2400 bps
  107.          9 = 9600 bps
  108.            Note: you'll soon find that the B parameter should be the last one
  109.          on your list.  If added to the N or P it will terminate processing
  110.          at that point, so make it the last one if you have more on the code
  111.          string.
  112.  
  113.  
  114.   /D?    where ? = S or , or . or * or 0
  115.            This is Delimiter parameter code.  When I first wrote A2T, I wrote
  116.          it for Judy's list which contained a period for the first delimiter
  117.          (which terminates the BBS name) and space for the second delimiter
  118.          (which terminates the phone number).  This strange case is still
  119.          the default if you don't give a delimiter parameter, but if you
  120.          give one, both the BBS name and BBS number delimiters become the
  121.          delimiter that you specify.
  122.          Here are the code parameter definitions:
  123.          S = a space delimiter
  124.          , = a comma delimiter
  125.          * = a star delimiter
  126.          . = a period delimiter
  127.          0 = no delimiter (you get the maximum characters for each field)
  128.  
  129.  
  130.   /I?    where ? = 0 through 9
  131.            This is the Ignore parameter code.  This will skip a given number
  132.          of FIELDS in the BBS list, before processing the BBS NAME.
  133.            Note that each field is terminated by a delimiter.  Since I
  134.          originally wrote A2T for a case in which the two delimiters were
  135.          different, the FIRST delimiter (a period) is used for the default
  136.          case.  This can be combined with the D config parameter to use
  137.          a different delimiter.
  138.            Also note that a delimiter consists of one character.  For example,
  139.          if you are using a space for a delimiter, and you have several spaces
  140.          before the BBS name is to be processed, they are each a field skip
  141.          and must be counted separately.  A total of 9 fields can be skipped.
  142.  
  143.  
  144.    Note: the following config codes must trail a name or phone number code,
  145.          so that is why they are listed AFTER the N or P code.
  146.  
  147.  
  148.   /N??d! where ?? = a 2 digit number, and ! = BBS name delimiter
  149.            This is the BBS name parameter code.  This will move to the Nth
  150.          COLUMN on one line of the BBS list before proceeding to process
  151.          the first field.  This parameter shouldn't be combined with the
  152.          I parameter.
  153.            The ?? field must be a two digit number, and it specifies the
  154.          Nth column to move to before processing the BBS name.  The number
  155.          must be two digits even if less than 10.  i.e. 09 is OK but 9 isn't.
  156.          After the ?? field is processed, a D (or L as described below)
  157.          parameter code is looked for.  In this way, you may specify a unique
  158.          delimiter for the BBS name.  The D parameter follows the same rules
  159.          as the global d parameter, and if left off will default to a period.
  160.            This code can be combined with the following P parameter, and used
  161.          to specify the starting columns for both the BBS name and phone number,
  162.          with unique delimiters for each.  Either the N or the P must be the
  163.          first parameter in the code list, i.e. the first character after the
  164.          backslash.
  165.  
  166.  
  167.   /P??d! where ?? = a 2 digit number, and ! = Phone Number delimiter
  168.            This is the phone number parameter code.  This will move to the Pth
  169.          COLUMN on one line of the BBS list before preceeding to process
  170.          the SECOND field, i.e. the phone number.  This parameter shouldn't
  171.          be combined with the I parameter.
  172.            The ?? field must be a two digit number, and it specifies the
  173.          Pth column to move over before processing the phone number. After
  174.          the ?? field is processed, a D (or L) code will be looked for.
  175.          Again, the ?? field must be a two digit number including numbers
  176.          less than 10, so 08 is OK but 8 isn't.  In this way, you can specify
  177.          a unique delimiter for the phone number.  The d parameter follows the
  178.          same rules as the global D parameter, and if left off will default
  179.          to a space.
  180.            This code can be combined with the preceeding N parameter, and used
  181.          to specify the starting columns for both the BBS name and phone number,
  182.          with unique delimiters for each.  Either the N or the P must be the
  183.          first parameter in the code list, i.e. the first character after the
  184.          backslash.
  185.            NOTE: unless the P parameter is used, the default will be to look
  186.          for the first occurance of digits after the BBS name delimiter or max
  187.          length occurred.
  188.  
  189.  
  190.   /N??L!! where !! = a 2 digit number.
  191.            This is the length parameter code.  This will specify the maximum
  192.          number of columns that either the name or the phone field can occupy.
  193.          This parameter can be added onto either the phone or name code but
  194.          shouldn't be combined with the delimiter parameter.
  195.            It is for the situation where you want to ignore delimiters and
  196.          simply take a specified number of characters beginning at the starting
  197.          column of either the name or the phone field.  The L must be followed
  198.          by a TWO digit parameter specifying the width of the field.  It comes
  199.          in very handy with bbs names that have spaces in the names but no
  200.          delimiter to terminate them.
  201.            If you go over the maximum of 25 characters for the name or 17
  202.          characters for the phone, then you will be given the maximum.
  203.  
  204.  
  205.  
  206.                        Setting up the BBS list file:
  207.  
  208.      THIS IS THE MOST IMPORTANT PART OF THE WHOLE DEAL.  As mentioned
  209.   earlier, I tailored the program after a popular list here in Houston,
  210.   and used the format of that list so that minor modifications to the
  211.   list would render it usable.
  212.      Three characters have special meanings in the ASCII text file.
  213.      They are:
  214.  
  215.      ';' -----> the semicolon IN THE FIRST COLUMN OF THE LINE, is used
  216.                 to comment out the whole line.  It is VERY important to
  217.                 comment out any line that is not going to be processed!
  218.  
  219.      '.' -----> (or the delimiter you gave on the command line)
  220.                 the period is used to terminate the NAME of the BBS.  This
  221.                 worked fairly well with Judy's list, although I did have
  222.                 to add a terminating period to one or two names, and one
  223.                 or two or three names terminated early because they had
  224.                 periods in the name.  Telix only allows 25 characters for
  225.                 a name, so it is wise to stay below this in your entries.
  226.  
  227.      ' ' -----> (or the delimiter you gave on the command line)
  228.                 the space is used to terminate the PHONE NUMBER of the BBS.
  229.                 Telix only allows 17 characters for a phone number,
  230.                 so it is wise to stay below this in your entries.
  231.  
  232. ;BBS List setup Example:
  233. ;             second is the number, variable length <= 17  (space terminates)
  234. ; Comment line        v
  235. BBS Name.........212-111-1111 Maybe a comment could be here...
  236. ;     ^
  237. ;     the name comes first, variable length <= 25  (period terminates)
  238. ;
  239. ; Note : this is the DEFAULT, you can override these settings with parameters
  240.  
  241.  
  242.      The rest of the information in the ASCII import file will be discarded.
  243.   There are some other givens that you should be aware of.  These are the most
  244.   common settings in a Telix dialing directory for an IBM PC or compatible
  245.   user:
  246.  
  247.      Parity    = NONE
  248.      Data Bits = 8
  249.      Stop Bits = 1
  250.      Protocol  = Zmodem
  251.      Emulation = ANSI-BBS
  252.      Script    = Left Blank
  253.      Password  = Left Blank
  254.  
  255.  
  256. Command line Examples:
  257.      A picture tells 2000 words (that is if you're in text mode)
  258.  
  259. MSDOS_Prompt> A2T [D:path\file] [[D:path\file]]  /config parameter (can appear
  260.                          ^              ^             anywhere on command line
  261.                          |              |             and consists of strings
  262.                          |              |             of codes)
  263.                          |              |
  264.                          |              |
  265.   This is the optional input file      This is the optional output file
  266.   parameter.  If left off, A2T         parameter which is only accessible
  267.   will assume an input file name       by entering the input parameter.
  268.   of 'input.bbs'.                      If left off, A2T will assume an
  269.                                        output filename of 'output.fon'.
  270.  
  271. Config parameter examples:
  272.   Note: the default (with no config parameter) is 2400bps, a period for the
  273.         first delimiter with processing beginning in the first column, and
  274.         a space for the second delimiter with processing beginning where the
  275.         numbers start.  Judy's 80COL.TXT BBS list will compile fairly well
  276.         with no parameters given.  To override these defaults, use config
  277.         parameters.
  278.  
  279. /D,I4          use comma for delimiter, skip 4 fields first
  280.  
  281. /B9DS          use bps rate of 9600, use a space for the delimiter
  282.  
  283. /B1DsI2        use bps of 1200, use a space for delimiter, ignore 1st 2 fields
  284.  
  285. /n01L22p23     start at column 1, use a length of 22 characters for the bbs
  286.               name, and start at column 23 for the phone number use the default
  287.               phone number delimiter of a space.  (a little secret : even though
  288.               I wrote the program defaults with Judy's 80COL.TXT in mind,
  289.               this results in a cleaner looking dial dir)
  290.  
  291. /n01d0p52L08   start looking for the name in col one, with the max width
  292.               for the field.  next get the phone number at col. 52 with a
  293.               length of 8 characters.  This works nicely on Judy's 64COL.TXT
  294.               BBS list.
  295.  
  296. /n12ds         start at the 12th column, use a space for a delimiter.  This
  297.               config works nicely on the PHOENIX Nodelist (with the Regional
  298.               Host Lines commented out).
  299.  
  300. /n59d0p01      start at the 59th column for the name and don't use a delimiter,
  301.               start at the 1st column for the phone number, use (default) space
  302.               for a delimiter.. this works nicely on USBBS66.LST (the eoln is
  303.               used for the bbs name delimiter, and since it's such a big list,
  304.               it will terminate at 1000 records.)
  305.  
  306. /n17L20p38     start at the 17th column for the name and use a maximum length
  307.               of 20 characters, then start at the 38th column for the phone
  308.               number and use (default) space for a delimiter.  this works nicely on
  309.               WORLDBBS.LST.  (although the format at the end of this list had
  310.               to be commented out since it was very chaotic. --got most of it
  311.               though.)
  312.  
  313.  
  314.  
  315.  
  316. Messages:
  317.   The + and * will click off for every 25 records that have been processed.
  318.  
  319.   If you simply enter :
  320.   MSDOS_Prompt> A2T
  321.   Then a help display will scroll on your screen. (you get same with A2T /?)
  322.  
  323.   "Output file exists.  Hit <ESC> to abort, any other key if OK."
  324.      If the output file you give exists, you will be notified.
  325.   You will be prompted to hit the <ESC> key to abort the compilation if you
  326.   do not want your output file overwritten.  If you hit any other key,
  327.   the compilation will proceed.
  328.  
  329.   "<BEEP>Sorry, one of your config codes has an error, try again."
  330.      The main causes for this message is you have a syntax error in your
  331.   config parameter list.
  332.  
  333.   "<BEEP>Sorry, the input file you gave doesn't exist, try again."
  334.      Self explanatory.
  335.  
  336.   "<BEEP>Sorry, your output/path has a problem, try again."
  337.      Self explanatory.
  338.  
  339.   Version info:
  340.  
  341.      1.0 - 12-24-89 This is it!  The first version.  I hope to add more
  342.                     enhancements very soon.
  343.  
  344.      1.1 - 12-24-89 Corrected a problem that occurred when the user
  345.                     entered an incorrect bps parameter.
  346.            
  347.      2.0 - 12-25-89 Added more parameter command line options and changed some.
  348.  
  349.      2.1 - 12-26-89 Improved the record processing display.
  350.  
  351.      2.2 - 12-27-89
  352.            * Added the N and P parameters and took away the M
  353.              parameter since the N will do the same thing and more.
  354.            * Improved the record processing display to display both
  355.              reading and writing.
  356.            * Added more error checking.
  357.            * Changed the default output filename to 'OUTPUT.FON'
  358.  
  359.      2.3 - 12-29-89
  360.            * Changed the default input filename to 'INPUT.BBS'.
  361.            * added the help screen for the ? parameter or A2T w/ no parameters.
  362.            * Added more error checking
  363.            * Added the L parameter
  364.  
  365.      2.3c  12-30-89
  366.            * a little better display of the processing
  367.            * a little better display of help
  368.  
  369.